NAME

HTMLTool - add HyperText Markup Language formatting to a document

SYNOPSIS

• HTMLTool [[-a attribute] ...] [-q] [-n] [-p prefixString] [-s suffixString] -i tag
• HTMLTool [[-a attribute] ...] [-q] [-n] [-p prefixString] [-s suffixString] -t tag
• HTMLTool [[-a attribute] ...] [-q] [-n] [-p prefixString] [-s suffixString] -T tag subTag
• HTMLTool [-q] [-n] [-p prefixString] [-s suffixString] -l
• HTMLTool [-q] [-p prefixString] [-s suffixString]

AVAILABILITY

This command (HTMLTool) only runs as a tool under the Macintosh Programmer's Workshop(TM).

DESCRIPTION

Apply HTML formatting commands to the text selected in the active window.

OPTIONS

-a attribute

Modifies tag, insert attribute before the '>' in the '<tag>', may appear multiple times.

-q

Quote (transform) characters in the selection, that are special to HTML, to their 'quoted' equivalent e.g. '<' becomes '&lt;'.

-n

Add newlines after each '<tag>' and '</tag>'.

-p prefixString

Prepend prefixString to the beginning of the selection (before anything else).

-s suffixString

Append suffixString to the end of the selection (after everything else).

-i tag

Insert '<tag>' at the beginning of the selected text. (mnemonic - 'individual' tag).

-t tag

Insert '<tag>' at the beginning of the selected text and append '</tag>' at the end of the selected text.

-T tag subTag

Insert '<tag>' at the beginning of the selected text and append '</tag>' at the end of the selected text. Insert '<subTag>' at the beginning of each line of selected text.

-l

Prompt for information used to create a hyper-link. The selected text is used as the 'anchor text' to execute the link.

NOTES

HTML tag types are basically: two part tags that surround data, individual tags that preceed data, and combinations of the two. HTMLTool really isn't too useful on it's own, it's primarily for use to build frequently used commands that are bound to keys or menu items. Pretty much all of the HTML 2.0 formatting can be done with some combination of the 5 basic usages of HTMLTool.

EXAMPLES

See HTML_Menu for examples.

HINTS

Quote your text before you apply formatting.

SEE ALSO

• A Beginner's Guide to HTML (Recommended!)
  
• Nathan Torkington's Primer
• HTML tutorials
• A Beginner's Introduction to HTML
• HTML: Adding More
• HTML: Advanced Features
• NetScape Extensions to HTML
• Creating High Impact Documents
• URL Standard
• Draft HTML 2.0 Spec

BUGS

None known :-). Send any problem reports/praise/suggestions to: tom@selene.utval.net

LEGAL NOTICE

HTMLTool is Copyright© 1995 by Thomas R. Kimpton, I retain all rights. HTMLTool (the MPW(TM)tool) is freeware, NOT public domain. HTMLTool may not be included in any collection of shareware or public domain software without my express knowledge and permission. You may, however, distribute it to your friends as long as it has not been modified and you include the entire HTMLTool package in its original form.

HTMLTool is supplied as is. Thomas R. Kimpton hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Thomas R. Kimpton will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Thomas R. Kimpton, or an agent of Thomas R. Kimpton has been advised of the possibility of such damages. In no event shall Thomas R. Kimpton's liability for any damages ever exceed the price paid for the license to use the software, regardless of the form of the claim. The person using the software bears all risk as to the quality and performance of the software.

phew!